Installing Passport Manager

---

This documentation is for non-Windows-based ports of Passport Manager version 1.1. For information about the differences between this and the current Windows-based version, see Passport 1.1 Operational Differences.

Before you install the Microsoft^® Passport Manager software, make sure your system meets all of the minimum requirements listed in the System Requirements (Non-Windows) section corresponding to your operating system.

To install Passport Manager version 1.1:

1. Obtain the software.

   You can download the Passport Manager version 1.1 software from the page titled Installing Passport Manager on Non-Windows Platforms.

   The software is downloaded in ZIP format. The ZIP file contains a shell script and a tar file:

   • pp_install.sh
   • passport.version.platform.tar

2. Install the Passport Manager files.

   Run the pp_install.sh shell script, which:

   1. Creates /usr/local/passport
   2. Untars the passport.version.platform.tar file
   3. Prompts for host name of the server
   4. Prompts for the "Disaster URL"
   5. Sets up the registry information
   6. Chowns the passport directory to the Web user

The following items are installed:

• Passport Manager object
• Header files for building your Web site
• Examples of Perl ASP pages
• Examples of CGI code and pages
• Examples of Apache API code and pages
• Examples of Netscape NSAPI code and pages

For more information about the files installed and their locations, see What Is Installed.

Notes

• You must install the Passport Manager so that the Web server can dynamically link to the Passport.so file. You can do this by becoming the Web server user or root before you run pp_install.sh.
• /usr/local/passport is the required location. pp_install.sh will create a symbolic link to /usr/local/passport if you prefer to install the Passport Manager at a different location.
• "Disaster URL" is the URL to connect to when Passport Manager requests operations that must use network services, but your server is unable to connect to the .NET Passport Nexus servers. This would ordinarily be the URL to a page somewhere on your site.
  
• Registry information: The installation kit generates a Registry directory that sets several registry keys. For more information, see Registry Settings.